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ABOUT THIS CHAPTER 


This chapter describes the SCSI Manager, the part of the Operating System that 
controls the exchange of information between a Macintosh and peripheral devices 
connected through the Small Computer Standard Interface (SCSI). 


The SCSI Manager is the Macintosh implementation of an SCSI bus and its attached 
devices. This chapter describes the routines and data structures 

you'll use to communicate between a Macintosh and peripherals over an SCSI bus. 
It also explains how to write an SCSI device driver that's capable of performing 
the Macintosh system startup. 


This chapter provides information needed to connect a device to the Macintosh 
via an SCSI bus; it is not intended as a guide to designing an SCSI device. A 
familiarity with the American National Standard Committee (ANSC) documentation 
for SCSI, specifically the ANSC X3T9.2/82-2 draft proposal, is assumed; the 
information provided in the draft proposal will not be repeated in this chapter. 


You should also already be familiar with: 


« the use of devices and device drivers, as described in the 
Device Manager chapter 

e sectors and file tags, as described in the Disk Driver chapter 

* any documentation provided with the particular SCSI device you want to 
connect to the Macintosh 
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ABOUT THE SCSI MANAGER 


The Small Computer Standard Interface (SCSI) is a specification of mechanical, 
electrical, and functional standards for connecting small computers with 
intelligent peripherals such as hard disks, printers, and optical disks. The 
SCSI Manager is the part of the Operating System that provides routines and data 
structures for communicating between a Macintosh and peripheral devices 
according to this industry-standard interface. 


Up to eight devices can be connected, in a daisy-chain configuration, to an SCSI 
bus. When two SCSI devices communicate with each other, one acts as the 
initiator and the other as the target. The initiator asks the target to perform 
a certain operation, such as reading a block of data. An SCSI device typically 
has a fixed role as an initiator or target; for instance, the Macintosh acts as 
initiator to a variety of peripherals acting as targets. There may also be 
intelligent peripherals capable of acting as initiators. Multiple initiators 

(as well as multiple targets) are allowed on an SCSI bus, but only one Macintosh 
can be connected to an SCSI bus at a time. 


Each device on the bus has a unique ID, an integer from 0 to 7. The Macintosh 
always has an ID of 7; peripheral devices should choose another number. 


At any given time, the Apple SCSI bus is in one of eight phases. When no SCSI 
device is actively using the bus, the bus is in the bus free phase. 


Since multiple initiators are possible, an initiator must first gain control of 
the bus; this process is called the arbitration phase. 


Note: If more than one initiator arbitrates for use of the bus at the same 
time, the initiator with the higher ID gains control first. Once an 
initiator (regardless of ID) gains control of the bus, no other device 
can interrupt that session. 


Once the initiator has gained control of the bus, it selects the target device 
that will be asked to perform a certain operation; this phase, known as the 
selection phase, includes an acknowledgement from the target that it has been 
selected. In the event that the target suspends (or disconnects) the 
communication, an optional phase, known as the reselection phase, lets the 
target reconnect to the initiator. 


In the command phase, the initiator tells the target what operation to perform. 
The data phase follows; this is when the actual transfer of data between 
initiator and target takes place. When the operation is completed, the target 
sends two completion bytes. The first byte contains status information and the 
second contains a message; they constitute the status phase and message phase 
respectively. 


A typical communication might involve a Macintosh requesting a block of data to 
be read from a hard disk connected via an SCSI bus. The Macintosh waits for a 
bus free phase to occur and then arbitrates for use of the bus. It selects the 
hard disk as target and sends the command for the read operation. The hard disk 
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transfers the requested data back to the Macintosh, completing the session by 
sending the status and message bytes. 


On the Macintosh SE and Macintosh II, the SCSIRBlind and SCSIWBlind functions 
have hardware support; this ensures that they will work reliably with most 
third-party SCSI drives. 


Warning: SCSI drivers that jump directly to the ROM will crash on any machine 
other than a Macintosh Plus. 
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USING THE SCSI MANAGER 


The SCSI Manager is automatically initialized when the system starts up. To gain 
control of the SCSI bus, call SCSIGet. To select a target device to perform an 
Operation (such as reading or writing data), call SCSISelect. The SCSICmd 
function tells the target device what operation to perform. 


To transfer data from the target device to the Macintosh, you can call SCSIRead; 
SCSIWrite transfers data from the Macintosh to the target device. The read and 
write operations can be performed without polling and waiting for the /REQ line 
on each data byte by calling SCSIRBlind and SCSIWBlind, respectively. All four 
read/write functions require a transfer instruction block telling the SCSI 
Manager what to do with the data bytes transferred during the data phase. 


The SCSIComplete function gives the current command a specified number of ticks 
to complete and then returns the status and message bytes. 


You can obtain a bit map of the SCSI control and status bits by calling 
SCSIStat. To reset the SCSI bus (typically when a device has left it ina 
suspended phase), call SCSIReset. 


Three new routines support the message phase of the SCSI standard. SCSISelAtn 
lets you select a device, alerting the device that you want to send a message. 
SCSIMsgOut sends a message byte to the device, and SCSIMsgIn receives a message 
byte from the device. 


Describing the Operation to be Performed 


You tell the SCSI Manager what operation to perform by passing a pointer to a 
command descriptor block; the SCSI command structure is outlined in the ANSC 
document X3T9.2/82-2. 


When the command to be performed involves a transfer of data (such as a read or 
write operation), you also need to pass a pointer to a transfer instruction 
block, which tells the SCSI Manager what to do with the data bytes transferred 
during the data phase. A transfer instruction block contains a pseudo-program 
consisting of a variable number of instructions; it's similar to a subroutine 
except that the instructions are provided and interpreted by the SCSI Manager 
itself. The instructions are of a fixed size and have the following structure: 


TYPE SCSIInstr = RECORD 


scOpcode: INTEGER; {operation code} 

scParam1: LONGINT; {first parameter} 

scParam2: LONGINT {second parameter} 
END; 


Eight instructions are available; their operation codes are specified with the 
following predefined constants: 
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CONST scInc = 1; {SCINC instruction} 
sCNoInc = 2; {SCNOINC instruction} 
scAdd =-3% {SCADD instruction} 
scMove = 4; {SCMOVE instruction} 
scLoop Sue {SCLOOP instruction} 
scNOp = 6; {SCNOP instruction} 
scStop = 7% {SCSTOP instruction} 
scComp = 8; {SCCOMP instruction} 


A description of the instructions is given below. 
opcode = scInc paraml = buffer param2 = count 


The SCINC instruction moves count data bytes to or from buffer, incrementing 
buffer by count when done. 


opcode = scNoInc paraml = buffer param2 = count 


The SCNOINC instruction moves count data bytes to or from buffer, leaving buffer 
unmodified. 


opcode = scAdd paraml = addr param2 = value 


The SCADD instruction adds the given value to the address in addr. (The addition 
is performed as an MC68000 long operation. ) 


opcode = scMove paraml = addrl param2 = addr2 


The SCMOVE instruction moves the value pointed at by addrl to the location 
pointed to by addr2. (The move is an MC68000 long operation. ) 


opcode = scLoop paraml = relAddr param2 = count 

The SCLOOP instruction decrements count by 1. If the result is greater than 0, 
pseudo-program execution resumes at the current address+relAddr. If the result 
is 0, pseudo-program execution resumes at the next instruction. RelAddr should 
be a signed multiple of the instruction size (10 bytes). For example, to loop to 
the immediately preceding instruction, the relAddr field would contain —10. To 
loop forward by three instructions, it would contain 30. 

opcode = scNOp paraml = NIL param2 = NIL 

The SCNOP instruction does nothing. 

opcode = scStop paraml = NIL param2 = NIL 


The SCSTOP instruction terminates the pseudo-program execution, returning to the 
calling SCSI Manager routine. 


opcode = scComp paraml = addr param2 = count 
The SCCOMP instruction is used only with a read command. Beginning at addr, it 


compares incoming data bytes with memory, incrementing addr by count when done. 
If the bytes do not compare equally, an error is returned to the read command. 
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Example 


This example gives a transfer instruction block for a transfer of six 512-byte 
blocks of data from or to address $67B50. 


SCINC $67B50 512 
SCLOOP -10 6 
SCSTOP 
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SCSI MANAGER ROUTINES 


Assembly-language note: Unlike most other Operating System routines, the SCSI 
Manager routines are stack-based. You can invoke each 
of the SCSI routines with a macro that has the same 
name as the routine preceded by an underscore. These 
macros, however, aren't trap macros themselves; 
instead they expand to invoke the trap macro 
_SCSIDispatch. The SCSI Manager determines which 
routine to execute from the routine selector, an 
integer that's passed to it in a word on the stack. 
The routine selectors for the new routines are as 


follows: 
scsiReset . EQU 0 
scsiGet . EQU 1 
scsiSelect . EQU 2 
scsiCmd . EQU 3 
scsiComplete .EQU 4 
scsiRead . EQU 5 
scsiWrite . EQU 6 
scsiRBlind . EQU 8 
scsiWBlind . EQU 9 
scsiStat . EQU 10 
scsiSelAtn . EQU 11 
scsiMsgIn . EQU 12 
scsiMsgOut .EQU 13 


If you specify a routine selector that's not defined, the System Error Handler 
is called with the system error ID dsCoreErr. 


Most of the SCSI Manager routines return an integer result code of type OSErr. 
Each routine lists all of the applicable result codes, along with a short 
description of what the result code means. Lengthier explanations of all the 
result codes can be found in the summary at the end of this chapter. The error 
scSequenceErr is not listed under each operation. It is returned when an 
attempted operation is out of sequence (calling SCSISelect without first calling 
SCSIGet, for instance). 


Warning: The error codes returned by SCSI Manager routines typically indicate 
only that a given operation failed. To determine the actual cause of 
the failure, you need to send another SCSI command asking the device 
what went wrong. 

FUNCTION SCSIReset : OSErr; 

SCSIReset resets the SCSI bus. 


Result codes noErr No error 
commErr Breakdown in SCSI protocols 
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FUNCTION SCSIGet : OSErr; 


SCSIGet arbitrates for use of the SCSI bus. 


Result codes noErr No error 
commErr Breakdown in SCSI protocols 
scArbNBErr Bus is busy 
scMgrBusyErr SCSI Manager busy with another operation 


FUNCTION SCSISelect (targetID: INTEGER) : OSErr; 
SCSISelect selects the device whose ID is in targetID. 


Result codes noErr No error 
commErr Breakdown in SCSI protocols 


FUNCTION SCSICmd (buffer: Ptr; count: INTEGER) : OSErr; 


SCSICmd sends the command pointed to by buffer to the selected target device. 
The size of the command in bytes is specified in count. 


Result codes noErr No error 
commErr Breakdown in SCSI protocols 
phaseErr Phase error 


FUNCTION SCSIRead (tibPtr: Ptr) : OSErr; 


SCSIRead transfers data from the target to the initiator, as specified in the 
transfer instruction block pointed to by tibPtr. 


Result codes noErr No error 
badParmsErr Unrecognized instruction in transfer instruction 
block 
commErr Breakdown in SCSI protocols 
compareErr Data comparison error (with scComp command 
in transfer instruction block) 
phaseErr Phase error 


FUNCTION SCSIRBlind (tibPtr: Ptr) : OSErr; 


SCSIRBlind is functionally identical to SCSIRead, but does not poll and wait for 
the /REQ line on each data byte. Rather, the /REQ line is polled only for the 
first byte transferred by each SCINC, SCNOINC, or SCCOMP instruction. For 
instance, given the following transfer instruction block 


SCINC $67B50 512 
SCLOOP -10 6 
SCSTOP 


SCSIRBlind polls and waits only for the first byte of each 512-byte block 
transferred. 


Result codes noErr No error 
badParmsErr Unrecognized instruction 
commErr Breakdown in SCSI protocols 
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compareErr Data comparison error 
phaseErr Phase error 
scBusTOErr Data not ready within the bus timeout period 


FUNCTION SCSIWrite (tibPtr: Ptr) : OSErr; 


SCSIWrite transfers data from the initiator to the target, as specified in the 
command descriptor block pointed to by tibPtr. 


Result codes noErr No error 
badParmsErr Unrecognized instruction 
commErr Breakdown in SCSI protocols 
phaseErr Phase error 


FUNCTION SCSIWBlind (tibPtr: Ptr) : OSErr; 


SCSIWBlind is functionally identical to SCSIWrite, but does not poll and wait 
for the /REQ line on each data byte. As with SCSIRBlind, SCSIWBlind polls the 
/REQ line only for the first byte transferred by each SCINC, SCNOINC, or SCCOMP 
instruction. 


Result codes noErr No error 
badParmsErr Unrecognized instruction 
commErr Breakdown in SCSI protocols 
phaseErr Phase error 
scBusTOErr Data not ready within the bus timeout period 


FUNCTION SCSIComplete (VAR stat,message: INTEGER; wait: LONGINT) : OSErr; 


SCSIComplete gives the current command wait number of ticks to complete; the two 
completion bytes are returned in stat and message. 


Result codes noErr No error 
commErr Breakdown in SCSI protocols 
phaseErr Phase error 
scComplPhaseErr Bus not in the Status phase (indicates 


that either filler bytes were written or 
bytes were read and lost) 


FUNCTION SCSIStat : INTEGER; 
This function returns a bit map of SCSI control and status bits; these bits are 


shown in Figure 1. See the NCR 5380 SCSI chip documentation for a description of 
these signals. (Bits 0-9 are complements of the SCSI bus standard signals.) 


Result codes noErr No error 
commErr Breakdown in SCSI protocols 
phaseErr Phase error 
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Figure 1-C 31 Control and Status Bits 

Figure 1-SCSI Control and Status Bits 
FUNCTION SCSISelAtn (targetID: INTEGER) : OSErr; 
SCSISetAtn is identical in function to SCSISelect except that it asserts the 
fora ha during selection, signaling that you want to send a message to 


FUNCTION SCSIMsgIn (VAR message: INTEGER) : OSErr; 


SCSIMsgIn gets a message from the device. The message is contained in the low- 
order byte of the message parameter; message values are listed in the ANSI 
documentation for SCSI. 


SCSIMsgIn leaves the Attention line undisturbed if it's already asserted upon 
entry. 


FUNCTION SCSIMsgOut (message: INTEGER) : OSErr; 


SCSIMsgOut sends a message byte to the target device; message values are listed 
in the ANSI documentation for SCSI. 
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TRANSFER MODES 


The Macintosh Plus SCSI Manager implements two transfer modes: polled and 
blind. The polled mode checks the DRQ signal on the 5380 SCSI chip before each 
byte is transferred (on both read and write operations). While slower than 
blind mode, the polled mode is completely safe since the SCSI Manager will wait 
indefinitely for each byte sent to or from the peripheral. 


The blind mode does not poll the DRQ line and is therefore about 50% faster. 
Use of this mode imposes certain timing constraints, however, making it 
unreliable for some peripherals. Once a transfer is underway, if the 
peripheral's controller cannot send (or receive) a byte every 2 microseconds, 
the SCSI Manager may either read invalid data or write data faster than the 
peripheral can accept it, resulting in the loss of data. 


Programmers writing SCSI device drivers must be familiar with the limits of 
their peripherals. If the peripheral has internal interrupts, for instance, or 
if it has processing overhead at unpredictable points within a block transfer, 
the blind mode should not be used. 


Note: If the peripheral has a regular pause at a specific byte number within 
a block, it's possible to use a transfer information block containing 
two or more data transfer pseudoinstructions. Since the SCSI Manager 
will handshake the first byte at the beginning of each data transfer 
Operation, this can be used to synchronize with the peripheral's 
internal processing. 


The Macintosh SE and Macintosh II have additional hardware support for SCSI data 
transfers. For compatibility, the faster transfer routines are still called 
SCSIRBlind and SCSIWBlind; these routines do, however, take advantage of the 
hardware handshaking available on the new machines. Use of the hardware 
handshake, however, imposes other timing constraints. If the time between any 
two bytes in a data transfer exceeds a certain period—between 265 and 284 
milliseconds on the Macintosh SE and approximately 16 microseconds on the 
Macintosh II—a CPU bus error is generated. If your peripheral cannot meet this 
constraint, you should use the polled mode calls, SCSIRead and SCSIWrite. 
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WRITING A DRIVER FOR A SCSI BLOCK DEVICE 


Device drivers are usually written in assembly language. The structure of a 
device driver is described in the Device Manager chapter. This section presents 
additional information to enable SCSI block devices to perform the Macintosh 
system startup. 


For each attached SCSI device, the ROM attempts to read in its driver prior to 
system startup. In order to be loaded, the device must place two data structures 
in the first two physical blocks. A driver descriptor map must be put at the 
start of physical block 0; it identifies the various device drivers available 
for loading (see Figure 2). The drivers can then be located anywhere else on the 
device and can be as large as necessary. 
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Figure 2—Driver Descriptor Map 


Figure 2—Driver Descriptor Map 


A second data structure, the device partition map, must be put at the start of 
physical block 1; it describes the allocation of blocks on the device for 
different partitions and/or operating systems (see Figure 3). 
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Figure 3-Derice Partition Map 


Figure 3—Device Partition Map 


Since there's no field in the device partition map for specifying the number of 
partitions, you need to signal the end of the map with a partition whose 
pdStart, pdSize, and pdFSID fields are set to 0. 


The system startup procedure takes the following steps: 


1. It attempts to select the first target device on the bus by its ID, 
beginning with the device, if any, having an ID of 6. 

2. It reads the first 256 bytes of physical block 0, checking for the 
Signature indicating a valid driver descriptor map ($4552). It then 
reads the device partition map from physical block 1 and checks for 
the proper signature ($504D). Note that old-style partition maps 
have a signature of ($5453) instead of ($504D). 

3. It searches the driver descriptor map for a driver for the Macintosh. 

4. It reads the driver from the indicated physical blocks into the system 
heap, using standard SCSI read commands. It checks for a proper driver 
Signature. 

5. It calls the driver to install itself, and passes a pointer to the 
device partition map for examination by the driver. 

6. It performs steps 1 through 5 for all other SCSI devices on the bus. 


Note: During system startup, the SCSI Manager may call SCSIReset after your 
driver has been loaded. 


Since the driver is called to install itself, it must contain code to set up its 
own entry in the unit table and to call its own Open routine. An example of how 
to do this can be obtained from 


Developer Technical Support 
Apple Computer, Inc. 

20525 Mariani Avenue, M/S 75-3T 
Cupertino, CA 95014 
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DISK PARTITIONING 


The previous section introduced the subject of booting from SCSI devices. It 
presents two data structures needed in the first two physical blocks of the 
device. The first data structure, the driver descriptor map, identifies the 
various device drivers available for loading. The second structure, the device 
partition map, presents a scheme for describing the allocation, or partitioning, 
of the blocks of a device between multiple operating systems. 


In order to support multiple operating systems on a single disk, the device 
partition map has been redesigned. The old partition map format is still 
supported, but developers are encouraged to adopt the new format (see below). 


Driver Descriptor Map 


A driver descriptor map must always be located at the start of physical block 0; 
its format is given in Figure 2. 


SBSig contains the signature; it's used to verify that the block is valid (that 
is, the disk has been formatted) and should always be $4552. 


SBDrvrCount specifies the number of drivers that may be used for this disk; more 
than one driver may be needed when multiple operating systems or processors are 
Supported. 


There must be a driver descriptor for each driver on the device (as well as a 
partition map entry, as explained below). DDBlock is the address of the first 
physical block of the driver code. DDSize contains the size of the driver in 
blocks. DDType identifies the operating system or processor supported by the 
driver. The Macintosh Operating System has the value 1; values 0 through 15 are 
reserved for use by Apple. 


To specify a particular operating system for use at system startup, you'll need 
to call the Start Manager routine SetOSDefault using the same value in ddType 
(see the Start Manager chapter). 


Partition Map 


For the purposes of this discussion, a partition is simply a series of blocks 
that have been allocated to a particular operating system, file system, or 
device driver. (Another way to look at it is that a single physical disk is 
divided into a number of logical disks.) The partition map organizes, or maps, 
this allocation of the physical blocks of a disk. It is strongly recommended 
that all operating systems that run on the Macintosh II use and support the 
partition map presented here. This will ensure the peaceful coexistence and 
operation of different operating systems on a single disk, and will enable the 
transfer of files between partitions. 
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To support the variety of disk types and sizes that can be attached to the 
Macintosh II, you should either allow for a variable number of partitions (to be 
determined at disk initialization), or allocate a large number (greater than 
100) of fixed partition slots. 


With the exception of physical block zero, every block on a disk must be 
accounted for as belonging to a partition. 


The partition map contains a number of physical blocks (as mentioned above, the 
old device partition map, located at physical block 1, has become logical block 
0 of the partition map). For each partition on a disk, the partition map has 
one block that describes the partition. The partition map is itself a partition 
and contains a partition map entry describing itself. Figure 4 gives an example 
of a partitioned disk. 


Driver description rag 
Partition rag ents (diver 
Partition rap entry [oT] 
Partition rag entey [partition reg] 
Fanttice Hag EMT map etter ne 
Fartiticn rag entry (hae OS) 
4/1 partition 
Wee 06 partition 
Other partitions 
Driver partition 


Figure 4-An Example of Disk Partitioning 
Figure 4—An Example of Disk Partitioning 


The information about a partition is contained in a partition map entry; it's 
shown in Figure 5. 
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Figure 5-Partition Map Entry 


Figure 5—Partition Map Entry 


The information in the fields marked with asterisks is used and expected by the 

Start Manager. The other fields may or may not be currently used; they've been 

defined to provide a convenient and standard way of storing information specific 
to your driver or operating system. To permit communication between partitions, 
it's recommended that you use these fields as described below. 


PMSig should always contain $504D to identify the block as containing a 
partition map entry. (The old partition map format, with a signature of $5453, 
is still supported but is discouraged. ) 


PMMapBlkCnt should contain the size in blocks of the partition map. The 
partition map entry for the partition map is not necessarily the first entry in 
the map. The number of blocks in the partition map is maintained in each entry, 
so that you can determine the size of the partition map from any entry in the 
map. 
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PMPyPartStart should give the physical block number of the first block of the 
partition and pmPartBlkCnt should contain the number of blocks in the partition. 


PMPartName and pmPartType are both ASCII strings of 1 to 32 bytes in Length; 
case is not significant. If either name is less than 32 characters long, it 
must be terminated by the NUL character (ASCII code 0). You can specify an 
empty name or type by setting the first byte to the NUL character. 


PMPartName is similar to the handwritten label on a floppy disk; you can use 
this field to store a user-defined name (which may or may not be the same name 
used by the operating system). 


PMPartType should indicate the operating system or driver using the partition. 
Types beginning with the string Apple name are reserved by Apple; the following 
standard types have been defined: 


Type Meaning 

Apple MFS Flat file system (64K ROM) 

Apple HFS Hierarchical file system (128K ROM and later) 
Apple _Unix_SVR2 Partition for UNIX 

Apple partition map Partition containing partition map 

Apple Driver Partition contains a device driver 

Apple PRODOS Partition designated for an Apple IIgs 

Apple Free Partition unused and available for assignment 
Apple Scratch Partition empty and free for use 


Programmers who wish to take advantage of a checksum verification performed by 
the Start Manager should give a partition type of Apple Driver and a partition 
name beginning with the letters "MACI" (for Macintosh). PMBootSize must contain 
the size in bytes of the boot code, while pmBootChecksum the checksum for that 
code, using the following algorithm: 


DoCksum 
moveq.l #0 ,D0O ;initialize sum register 
moveq.l #0,D7 ;zero-extended byte 
bra.s CkDecr ;handle 0 bytes 
CkLoop 
move.b (AQ)+,D7 ;get a byte 
add.w D7,DO ;add to checksum 
rol.w #1,D0 sand rotate 
CkDecr 
dbra D1,CkLoop ;next byte 
tst.w DO ;convert a checksum of 0 
bne.s @l ; into $FFFF 
subq.w #1,D0 . 
@l 


With some operating systems—for instance Apple's A/UX™ operating system-—the file 
system may not begin at logical block 0 of the partition. You should use 
pmLgDataStart to store the logical block number of the first block containing 
the file system data and pmDataCnt to specify the size in blocks of that data 
area. 
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The low-order byte of pmPartStatus (currently used only by A/UX) contains status 
information about the partition, as follows: 


Bit Meaning 


Set if a valid partition map entry 

Set if partition is already allocated; clear if available 

Set if partition is in use; might be cleared after a system reset 
Set if partition contains valid boot information 

Set if partition allows reading 

Set if partition allows writing 

Set if boot code is position independent 

Free for your use 


NOUBWNEF © 


The high-order byte of pmPartStatus is reserved for future use. 


PMLgBootStart specifies the logical block number of the first block containing 
boot code. 


PMBootLoad specifies the memory address where the boot code is to be loaded; 
pmBootLoad2 contains additional load information. 


PMBootEntry specifies the memory address to which the boot code will jump after 
being loaded into memory; pmBootEntry2 contains additional information about 
this address. 


PMProcessor identifies the type of processor that will execute the boot code. 
It's an ASCII string of 1 to 16 bytes in length; case is not significant. If 
the type is less than 16 characters long, it must be terminated by the NUL 
character (ASCII code 0). You can specify an empty processor type by setting 
the first byte to the NUL character. The following processor types have been 
defined: 


68000 
68008 
68010 
68012 
68020 


Partitioning Guidelines 


Developers writing disk partitioning (or repartitioning) programs should 
remember the following basic guidelines: 


¢ Every block on a disk, with the exception of physical block 0, must belong 
to a partition. Unused blocks are given the partition type Apple Free. 


e Every partition must have a partition map entry describing it. Remember 
that the partition map is itself a partition, with a partition map entry 
describing it. Partition map entries can be in any particular order, and 
need not correspond to the order in which the partitions they describe are 
located on the disk. 
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Each device driver must be placed in its own partition (as opposed to 
being in the partition of the operating system associated with it). This 
Simplifies the updating of the driver descriptor map when the driver is 
moved. 


Repartitioning of a disk is a two-step process where existing partitions 
must be combined to form new partitions. The existing partitions to be 
combined must first be marked as type Apple Free. As part of freeing a 
partition, you must set to zero the first eight blocks (copying the 
contents of the partition somewhere else) to ensure that the partition is 
not mistaken for an occupied partition. Once freed, the existing 
partitions can be combined with adjacent free partitions to make a single, 
larger partition. 


If, as a result of repartitioning, the partition map needs additional 
room, the other existing partitions can be shifted towards the "end" of 
the disk. The partition map is the only partition that can be extended 
without first destroying its contents. 
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SUMMARY OF THE SCSI MANAGER 


Constants 
CONST 


{ Transfer instruction operation codes } 


scInc =): {SCINC instruction} 
scNoInc = 2; {SCNOINC instruction} 
scAdd = 3" {SCADD instruction} 
scMove = 4; {SCMOVE instruction} 
scLoop =. 5% {SCLOOP instruction} 
scNop = 6; {SCNOP instruction} 
scStop = 7; {SCSTOP instruction} 
scComp = 8; {SCCOMP instruction} 


{ SCSI Manager result codes } 


scCommErr 2 Breakdown in SCSI protocols: usually no device 
connected or bus not terminated 


scArbNBErr 3 Arbitration failed during SCSIGet; bus busy 
scBadParmsErr 4 Unrecognized instruction in transfer 
instruction block 
scPhaseErr 5 Phase error: target and initiator not in 
agreement as to type of information to transfer 
scCompareErr 6 Data comparison error during read (with SCCOMP 
instruction in transfer instruction block) 
scMgrBusyErr 7 SCSI Manager busy with another operation 
when SCSIGet was called 
scSequenceErr 8 Attempted operation is out of sequence; 
e.g., calling SCSISelect before doing SCSIGet 
scBusTOErr 9 Bus timeout before data ready on SCSIRBlind 


and SCSIWBlind 
scComplPhaseErr 10 SCSIComplete failed; bus not in Status phase 


Data Types 
TYPE 
SCSIInstr = RECORD 
scOpcode: INTEGER; {operation code} 
scParam1: LONGINT; {first parameter} 
scParam2: LONGINT {second parameter} 
END; 
Routines 
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FUNCTION SCSIReset : OSErr; 

FUNCTION SCSIGet : OSErr; 

FUNCTION SCSTISelect (targetID: INTEGER) OSErr; 

FUNCTION SCSICmd (buffer: Ptr; count: INTEGER) OSErr; 
FUNCTION SCSIRead (tibPtr: Ptr) OSErr; 

FUNCTION SCSIRBLind (tibPtr: Ptr) OSErr; 

FUNCTION SCSIWrite (tibPtr: Ptr ) OSErr; 

FUNCTION SCSIWBLind (tibPtr: Ptr) OSErr; 

FUNCTION SCSIComplete (VAR stat,message: INTEGER; wait: LONGINT) OSErr; 
FUNCTION SCSIStat : LONGINT; 

FUNCTION SCSTISelAtn (targetID: INTEGER) : OSErr; 

FUNCTION SCSIMsgIn (VAR message: INTEGER) : OSErr; 

FUNCTION SCSIMsgOut (message: INTEGER) : OSErr; 


Assembly-Language Information 
Constants 


; Transfer instruction operation codes 


scInc . EQU 1 ;SCINC instruction 
scNoInc . EQU 2 ;SCNOINC instruction 
scAdd .EQU 3 ;SCADD instruction 
scMove . EQU 4 ;SCMOVE instruction 
scLoop . EQU 5 ;SCLOOP instruction 
scNOp . EQU 6 ;SCNOP instruction 
scStop . EQU 7 ;SCSTOP instruction 
scComp . EQU 8 ;SCCOMP instruction 


Routine selectors 

(Note: You can invoke each of the SCSI Manager routines 
with a macro that has the same name as the routine 
preceded by an underscore. ) 


. 
# 
. 
¥ 
. 
i 9 
. 
| 


scsiReset . EQU 0 
scsiGet . EQU 1 
scsiSelect . EQU 2 
scsiCmd . EQU 3 
scsiComplete .EQU 4 
scsiRead . EQU 5 
scsiwWrite . EQU 6 
scsiRBlind . EQU 8 
scsiWBlind . EQU 9 
scsiStat . EQU 10 
scsiSelAtn . EQU 11 
scsiMsgIn .EQU 12 
scsiMsgOut .EQU 13 


; SCSI Manager result codes 


scBadParmsErr .EQU 4 ;unrecognized instruction in transfer 
s instruction block 
scCommErr . EQU 2 ;breakdown in SCSI protocols: usually no 
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» device connected or bus not terminated 


scCompareErr .EQU 6 ;data comparison error during read (with scComp 


scPhaseE 


» command in transfer instruction block) 
rr .EQU 5 ;phase error: target and initiator not in 
; agreement as to type of information to transfer 


Structure of Driver Descriptor Map 


sbSig Always $4552 (word) 

sbBlockSize Block size of device (word) 
sbBLkCount Number of blocks on device (long) 
sbDevType Used internally (word) 

sbDevID Used internally (word) 

sbData Used internally (long) 

sbDrvrCount Number of driver descriptors (word) 


Driver Descriptor Structure 


ddBlock 
ddSize 
ddType 


First block of driver (long) 
Driver size in blocks (word) 
System type; 1 for Macintosh 


Structure of Partition Map Entry 


pmSig 
pmSigPad 


Always $504D (or $5453 for old format) (word) 
Reserved for future use (word) 


pmMapBLkCnt Number of blocks in partition map (long) 


pmPyPartStart First physical block of partition (long) 
pmPartBlkCnt Number of blocks in partition (long) 
pmPartName Partition name (1-32 bytes) 

pmPartType Partition type (1-32 bytes) 
pmLgDataStart First logical block of data area (long) 
pmDataCnt Number of blocks in data area (long) 
pmPartStatus Partition status information (long) 
pmLgBootStart First logical block of boot code (long) 
pmBootSize Size in bytes of boot code (long) 
pmBootLoad Boot code load address (long) 
pmBootLoad2 Additional boot load information (long) 


pmBootEn 
pmBootEn 


try Boot code entry point (long) 
try2 Additional boot code entry information (long) 


pmBootCksum Optional checksum (long) 


pmProces 
Addition 


sor Processor type (1-16 bytes) 
al boot-specific arguments (128 bytes) 


Trap Macro Name 


_SCSIDis 


(Note: 


patch 


You can invoke each of the SCSI Manager routines with a macro that 
has the same name as the routine preceded by an underscore. ) 
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Further Reference: 


Device Manager 

Disk Driver 

Technical Note #65, Macintosh Plus Pinouts 
Technical Note #96, SCSI Bugs 

Technical Note #134, Hard Disk Medic & Booting Camp 
Technical Note #159, Hard Disk Hacking 

Technical Note #258, Our Checksum Bounced 
"Macintosh Family Hardware Reference" 


END OF DOCUMENT 
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